tsutils

What is tsutils?

The tsutils package provides a set of utility functions for working with TypeScript. It is particularly useful for developers building TypeScript tools and plugins, as it offers a variety of functions to manipulate and analyze TypeScript code.

What are tsutils's main functionalities?

Type Guards

This feature provides type guard functions to check the type of TypeScript nodes. In the example, `isVariableStatement` is used to check if a node is a variable statement.

const ts = require('typescript');
const tsutils = require('tsutils');

const node = ts.createSourceFile('example.ts', 'let x: number = 42;', ts.ScriptTarget.Latest);

if (tsutils.isVariableStatement(node.statements[0])) {
  console.log('This is a variable statement');
}

AST Utilities

AST (Abstract Syntax Tree) utilities help in traversing and manipulating the AST of TypeScript code. The example demonstrates how to find all variable declarations in a source file.

const ts = require('typescript');
const tsutils = require('tsutils');

const sourceFile = ts.createSourceFile('example.ts', 'let x: number = 42;', ts.ScriptTarget.Latest);

const variableDeclarations = tsutils.findVariableDeclarations(sourceFile);
console.log(variableDeclarations);

Type Utilities

Type utilities provide functions to work with TypeScript types. The example shows how to check if a variable's type is a number using `isTypeFlagSet`.

const ts = require('typescript');
const tsutils = require('tsutils');

const program = ts.createProgram(['example.ts'], {});
const checker = program.getTypeChecker();
const sourceFile = program.getSourceFile('example.ts');

sourceFile.forEachChild(node => {
  if (ts.isVariableDeclaration(node)) {
    const type = checker.getTypeAtLocation(node);
    console.log(tsutils.isTypeFlagSet(type, ts.TypeFlags.Number)); // true if the type is a number
  }
});

Other packages similar to tsutils

typescript-eslint

typescript-eslint is a set of tools for using ESLint with TypeScript. It includes a parser and a set of rules that help in linting TypeScript code. While tsutils focuses on utility functions for TypeScript AST and types, typescript-eslint is more about integrating TypeScript with ESLint for code quality and style enforcement.

ts-morph

ts-morph is a library for TypeScript compiler API wrapper. It simplifies the process of working with the TypeScript AST and provides a higher-level API compared to tsutils. While tsutils offers utility functions, ts-morph provides a more comprehensive and user-friendly interface for manipulating TypeScript code.

babel-plugin-transform-typescript

babel-plugin-transform-typescript is a Babel plugin that allows Babel to transform TypeScript code. It is used for compiling TypeScript to JavaScript. Unlike tsutils, which provides utility functions for TypeScript AST and types, this plugin focuses on the transformation of TypeScript code during the build process.

README

Utility functions for working with typescript's AST

Roadmap

• v1.x
  • Add tests - currently this package is implicitly tested through the dependent packages tslint and tslint-consistent-codestyle
  • Add contributing guidelines

Changelog

1.9.1

Bugfixes:

• isObjectFlagSet now uses the correct objectFlags property